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C LANGUAGE INTERFACE 
int tgent (char *buffer, char *term ) 

buffer: storage for termcap entry or (GNU) null 
term : name of terminal type 
-1: termcap database not found 
0: term not found in database 

int tgetnum (char *name ) 

name : name of numeric capability 
-1: capability not found 

int tgetflag (char *name ) 

name : name of boolean capability 
0: capability not found 
1: capability found 

char *tgetstr (char *name, char **area ) 

name : name of string capability 

area : pointer to pointer to storage or (GNU) null 

NULL: capability not found 

char *tparam (char *str, char *buf, int size, ...) 

str : string capability (from tgetstr) 
buf: buffer to place output into 
size : size of the buffer 

char *tgoto (char *str, int x, int y) 

str : string capability (usually cm) 
x, y : screen coordinates to move to 

int tputs (char *str, int n, int (*/n)(int)) 

str : string to output with padding 

n : number of lines affected 

fn : function to output one character 

CAPABILITIES 

Inverse video, underlining, etc. 


SO 

str 

enter standout mode 

se 

str 

leave standout mode 

us 

str 

enter underlining mode 

ue 

str 

leave underlining mode 

mb 

str 

enter blinking mode 

md 

str 

enter bright mode 

mh 

str 

enter dim mode 

mk 

str 

enter invisible mode 

mp 

str 

enter protected mode 

mr 

str 

enter reverse mode 

me 

str 

leave special modes 

sa so 

us mr mb mh md mk mp as 


str 

turn on combination modes 

ms 

bool 

safe to move in special modes 

as 

str 

enter line-drawing mode 

ae 

str 

leave line-drawing mode 

Special cursor modes 

VS 

str 

enhanced cursor 

vi 

str 

invisible cursor 

ve 

str 

normal cursor 


Cursor motion 


cmyx 

str 

move to line y, column x. 

ho 

str 

move to top left 

11 

str 

move to bottom left 

cr 

str 

move to beginning of line 

nw 

str 

move to start of next line 

ch c 

str 

move to column c 

cv r 

str 

move to line r 

sc 

str 

save the current position 

rc 

str 

restore the current position 

le 

str 

move left 

nd 

str 

move right (“nondestructive”) 

up 

str 

move up 

do 

str 

move down 

DO n, UP n, LE n, RI n 


str 

move down/up/left/right n times 

ta 

str 

move to the next tab stop 

bt 

str 

move to the previous tab stop 

bw 

bool 

can backspace onto previous line 

am 

bool 

last column wraps to a new line 

Clearing the screen, lines, characters 

cl 

str 

clear screen, move to top left 

cd 

str 

clear rest of screen 

ce 

str 

clear rest of line 

ec n 

str 

clear n chars, no motion 


Inserting and deleting lines, characters 


al 

str 

insert line before cursor 

dl 

str 

delete line after cursor 

AL n 

str 

insert n lines 

DL n 

str 

delete n lines 

im 

str 

enter insert mode 

ei 

str 

leave insert mode 

ic 

str 

insert a character 

IC n 

str 

insert n characters 

ip 

str 

padding after inserted character 

mi 

bool 

safe to move in insert mode 

dm 

str 

enter delete mode 

ed 

str 

leave delete mode 

dc 

str 

delete a character 

DC n 

str 

delete n characters 

Scrolling 


sf 

str 

scroll up (use at bottom line) 

sr 

str 

scroll down (use at top line) 

cs nm 

str 

set scroll region: lines n to m 

cS sab s 

set scroll region: screen size s, 


str 

a lines above, b below. 


Ringing the bell 

bl str ring the bell 

vb str visual bell 

Screen size (use TIOCGWINSZ instead) 
co num screen width (columns) 

li num screen height (lines) 
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Initialization 


ti 

str 

start using termcap features 

te 

str 

done using termcap features 

is 

str 

initialize (at login) 

if 

str 

name of initialization file 

il..i3 

str 

more login-time init strings 

rs 

str 

reset to sane state 

ct 

str 

clear all tabs 

St 

str 

set a tab at current position 

it 

num 

standard width of tab stops 

Special 

keys 


km 

bool 

has meta key 

mm 

str 

enable meta key 

mo 

str 

disable meta key 

ks 

str 

enter keypad mode 

ke 

str 

leave keypad mode 

kl 

str 

sequence sent by left arrow 

kr 

str 

sequence sent by right arrow 

ku 

str 

sequence sent by up arrow 

kd 

str 

sequence sent by down arrow 

K1..K5 

str 

sequences sent by diag. arrows 

kl..k9, kO str 

sequences sent by function keys 

11. .19, 10 str 

names of function keys 

kb 

str 

sequence sent by backspace key 

kN 

str 

sequence sent by page down key 

kP 

str 

sequence sent by page up key 

kF 

str 

sequence sent by scroll down 

kR 

str 

sequence sent by scroll up 

kl 

str 

sequence sent by insert key 

kM 

str 

sequence sent by end insert key 

kD 

str 

sequence sent by delete key 

kL 

str 

sequence sent by delete line 

kC 

str 

sequence sent by clear screen 

kE 

str 

sequence sent by clear line key 

kS 

str 

sequence sent by clear to end 

kh 

str 

sequence sent by home key 

kH 

str 

sequence sent by home down key 

kT 

str 

sequence sent by tab set key 

ka 

str 

sequence sent by clear all tabs 

kt 

str 

sequence sent by clear tab key 

ko 

str 

names of other special keys 

Padding 


pb 

num 

don’t pad slower than this 

pc 

str 

string to use for padding 

dC 

num 

padding for \r 

dN 

num 

padding for \n 

dB 

num 

padding for \b 

dF 

num 

padding for \f 

dT 

num 

padding for \t 

Status line 


hs 

bool 

has status line 

es 

bool 

normal cmds work in status line 

ws 

num 

width of status line 

ts 

str 

start using status line 

fs 

str 

done filling status line 

ds 

str 

hide status line 


Attached printers 

ps 

str 

print a copy of the screen 

po 

str 

start redirecting to printer 

pf 

str 

stop redirecting to printer 

pO n 

str 

redirect next n chars to printer 

Hardcopy terminals 

he 

bool 

is hardcopy 

os 

bool 

can overstrike 

ul 

bool 

can overstrike character 

eo 

bool 

spaces do not overstrike 

hu 

str 

move half a line up 

hd 

str 

move half a line down 

ff 

str 

eject page 

Miscellaneous 


xn 

bool 

last column wraps weirdly 

LP 

bool 

last column will not force scroll 

ns 

bool 

last line will not cause scrolling 

da 

bool 

sr restores from scrollback 

db 

bool 

sf restores from scrollback 

lm 

num 

amount of scrollback saved 

nl 

str 

scroll or move down (obs.) 

CM y * 

str 

memory-relative cursor move 

rp nm 

str 

repeat ASCII character n, m times 

CC 

str 

default command character (ESC) 

in 

bool 

inserted and cleared spaces differ 

wi tb I r str 

window: top, bottom, left, right 

xs 

bool 

only ce clears standout 

sg 

num 

junk left by so, se 

ug 

num 

junk left by us, ue 

uc 

str 

underline char, move right 

nc 

bool 

\r does not work for cr (obs.) 

bs 

bool 

\b works for le (obs.) 

xt 

bool 

\t does not work for ta; 
cursor can’t be on standout junk. 

hz 

bool 

cannot output tildes 

xb 

bool 

cannot send ESC or Control-C 

NF 

bool 

does not support XON/XOFF 

gn 

bool 

is “generic” 


TGOTO / TPARAM ESCAPES 
%% output % 

%d parameter as decimal number 

%2 parameter as 2-digit number 

%3 parameter as 3-digit number 

%. parameter as character 

%+c character c incremented by parameter 
%i increment next two parameters 

%r swap next two parameters 

%s ignore next parameter 

%b go back to previous parameter 

%c ab if param is greater than a, add b 

%aotp do math on parameters 

%n xor next two parameters by 0140 

%m complement next two parameters 

%B BCD encode next par ameter 

%D encode next parameter for Delta Data 



